home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 December / EnigmA AMIGA RUN 23 (1997)(G.R. Edizioni)(IT)[!][issue 1997-12][EAR-CD VII].iso / recent2 / benchclock.readme < prev    next >
Text File  |  1997-11-11  |  6KB  |  191 lines
  1. Short:    BenchClock V1.60 - Real Digital Clock for WB or any PubScreen
  2. Author:   pliukko@jmp.fi (Pertti Liukkonen)
  3. Uploader: pliukko@jmp.fi (Pertti Liukkonen)
  4. Version:  1.60
  5. Type:     util/time
  6. Requires: OS 2.04+
  7. Replaces: util/time/BenchClock.lha
  8.  
  9. BenchClock 
  10. ----------
  11. A small and very configurable digital clock for Workbench or any
  12. Public Screen with Screennotify.library support. 
  13. 100% Assembly coded using Asm-One 1.29.
  14.  
  15. Fifth public release 5 Nov 1997, V1.60 Freely Distributable FREEWARE
  16. BenchClock (C) 1997 Peolli productions (Pertti Liukkonen)
  17.  
  18. What's New? - look 'History'!
  19.  
  20. Requirements
  21. ------------
  22. Kickstart 2.04 or better.
  23.  
  24.  
  25. OPTIONS (33 TOOLTYPES)    
  26. -----------------------
  27. PUBSCREEN     (BOOL)  Name of Public Screen where the window should be opened
  28.                       If NULL, window will opened in a default public screen
  29. SCREENNOTIFY  (BOOL)  Window will be closed automatically when Workbench
  30.               screen is changed. After WB has done the update,
  31.                       window will be opened again.
  32.                       Requires screennotify.library V1.0 (C) Stefan Becker 
  33. BACKDROP      (BOOL)  Backrop-style window
  34. STAYFRONT     (BOOL)  Window stays on front of all the other windows 
  35. BORDERLESS    (BOOL)  Borderless window
  36.  
  37. LEFT          (INT)   The position of window's left edge. (>=0)
  38. TOP           (INT)   The postiton of window's top edge (>=0)
  39. DIGWIDTH      (INT)   Width of the digits  (>=1)
  40. DIGHEIGHT     (INT)   Height of the digits (>=1)
  41.  
  42. 12HOURS       (BOOL)  12 hour mode, AM/PM will be added
  43. SECONDS       (BOOL)  Displays seconds
  44. UPDATESECS    (INT)   Delay between updates
  45.  
  46. NOCLOSEGADGET (BOOL)  Hides close gadget 
  47.                       (window can be always closed via menus)
  48. NODEPTHGADGET (BOOL)  Hides depth gadget
  49. NODRAGBAR     (BOOL)  Hides window dragbar
  50. NOWINTITLE    (BOOL)  Hides window title
  51.  
  52. VERSEGSIZE    (INT)   Size of the vertical segments  (1-3 pixels)
  53. HORSEGSIZE    (INT)   Size of the horizontal segments (1-3)
  54. MIDSEGSIZE    (INT)   Size of the middle segment (1-3)
  55.  
  56. BGCOLOR       (INT)   Background color (>=0)
  57. SHDWCOLOR     (INT)   Shadow color (unused segments) (>=0)
  58.  
  59. COLONFGCOLOR  (INT)   Colon Foreground color (>=0)
  60. SECFGCOLOR    (INT)   Foreground color for seconds (>=0)
  61. MINFGCOLOR    (INT)   Foreground color for minutes (>=0)
  62. HOURFGCOLOR   (INT)   Foreground color for hours (>=0)
  63. AMPMCOLOR     (INT)   Color for AM/PM (>=0)
  64.  
  65. COLONBLINK    (BOOL)  Makes colons to blink
  66.  
  67. EXTRABORDER   (INT)   Draws extra border around the display. Currently only
  68.                       one type (=1). For best results adjust XSPACE and 
  69.                       YSPACE.
  70. EBCOLOR1      (INT)   Color #1 for EXTRABORDER
  71. EBCOLOR2      (INT)   Color #2 for EXTRABORDER
  72.  
  73. SPACE         (INT)   The space between hours-minutes-seconds (>=0)
  74. XSPACE        (INT)   The space between the numbers and the window's vertical
  75.                       borders (>=0)
  76. YSPACE        (INT)   The space between the numbers and the window's 
  77.                       horizontal borders (>=0)
  78.  
  79. Menus
  80. -----
  81. If you have set NOCLOSEGADGET, you can quit BenchClock from the Main menu.
  82. Also STAYFRONT can be enabled/disabled from the Options menu. 
  83.  
  84. Installation
  85. ------------
  86. Copy the program (BenchClock) and the icon (BenchClock.info) to WbStartup
  87. or anywhere you like.
  88.  
  89.  
  90. Usage
  91. -----
  92. Program can be launched from Workbench or CLI.
  93.  
  94. Workbench: Double click the BenchClock Icon
  95. CLI:       BenchClock <iconfilename> NOTE: filename WITHOUT ".info"!
  96.  
  97. NOTICE: When you run the BenchClock from the CLI, prefs will be loaded
  98. from the default icon file (<Program name> + ".info")
  99. You can also specify other icon file, for example typing in command line:
  100. BenchClock temp:icons/BC2 (opens BC2.info file) 
  101.  
  102.  
  103. If you want to use SCREENNOTIFY feature you need also screennotify.library.
  104. You can get it from Aminet. ("util/libs/ScreenNotify10.lha" - 19k)
  105.  
  106. Configuration has to be made using tooltypes.
  107.  
  108.  
  109. Known Bugs
  110. ----------
  111. None.
  112.  
  113. Use reasonable values only with the tooltypes! It shouldn't crash your 
  114. system, if you use it right. But it may, so please inform me about any 
  115. bugs. When an error occures BenchClock doesn't print out any messages.
  116.  
  117. I don't take any responsibilities of any damage on your system that 
  118. BenchClock may cause.
  119.  
  120.  
  121. Future Improvements
  122. -------------------
  123. Because I want to keep the executable quite small and limit the memory 
  124. usage, only few improvement will be made. Some ideas:
  125.  
  126. - Advanced screennotify.library support
  127. - Adjustable size for each digit
  128. - More extra borders
  129. - Date/alarm
  130.  
  131. These are coming, but not very soon. I have also other projects going on.
  132. Your suggestions are always welcome. Good user suggestions will be 
  133. implemented first.
  134.  
  135. - And of course bug fixes, if there founds any.
  136.  
  137.  
  138. History
  139. -------
  140. V1.60 Fifth public release 5 Nov 1997.
  141.       Bloody bug fixed: BenchClock was quite unusable when launched
  142.       from cli without filename; sometimes crashed totally, sometimes 
  143.       the BC display went crazy...
  144.       Added screennotify.library support. Only works with Workbench 
  145.       screen now.
  146.  
  147. V1.55 Fourth public release 16 Oct 1997.
  148.       Bug fixed: V1.54 didn't free all memory in 24 hour mode.
  149.       Added Benchclock.guide
  150.  
  151. V1.54 Third public release 14 Oct 1997.
  152.       Bug fixed: Program caused some BYTE-READ Enforcer hits in startup
  153.       (Silly, but not so dangerous bug.)
  154.       Added full window dragging. It's possible to move a NODRAGBAR 
  155.       window now. Some optimizations.
  156.  
  157. V1.53 Minor changes. Added stayfront menu shortcut. 
  158.  
  159. V1.52 Second public release 13 Oct 1997. 
  160.       Added EXTRABORDER, EBCOLOR1 and EBCOLOR2. New Options menu with
  161.       Stayfront toggle. Tooltypes reorganized. Some minor code changes.
  162.  
  163. V1.51 Bug fixed: STAYFRONT was incompatible with PowerSnap; snapping
  164.       was interrupted in updates. Reported by Fredrik Ismyren, thanks! 
  165.  
  166. V1.5  First public release
  167.  
  168. V1.0 - V1.4 Internal beta versions
  169.  
  170.  
  171. Thanks
  172. ------
  173. o To all BenchClock users and bug reporters!
  174. o For all suggestions.
  175. o Tommi Liukkonen for beta testing and some ideas.
  176. o Amiga - Only Amiga makes it possible.
  177.  
  178.  
  179. Author
  180. ------
  181. Feel free to contact for any reason:
  182.  
  183. Peolli productions (Pertti Liukkonen), Finland
  184. Email : pliukko@jmp.fi
  185. URL   : http://www.jmp.fi/~pliukko/   
  186.  
  187. I'm also very interested in how many BenchClock users there is...
  188. so please send some email if you are using it!
  189.  
  190. My english is not perfect, but I hope you got the point ;)
  191.